BIDRIDGE FOR DESKTOP
====================

BidRidge in its own window on Windows, Mac or Linux: all trades, proposals
and PDFs, the lead inbox, track record and backups. Works without internet.

It opens in Microsoft Edge or Google Chrome (in app mode, with no browser
bars). Windows already has Edge. On a Mac or Linux computer, install Chrome
or Edge first for the best experience; otherwise it opens in your normal
browser.

Your company setup: if your provider gave you a setup.json file, put it in
the same folder as the program (on a Mac, next to BidRidge.app). BidRidge
starts already set up. Otherwise it asks a few setup questions the first time.

Updates: BidRidge updates itself. When it opens and you're online, it checks
bid-ridge.com for a newer version and downloads it; the next time you open
BidRidge, you're on the new version (a note says when one is ready). Updates
are signed by BidRidge and checked before they're used. Your jobs stay put.

Free trial and license: BidRidge is free for 14 days on each computer. To keep
making estimates after that, buy a license on the BidRidge website, then open
License in the app, enter your key (BR-...) and click Activate. One key works
on 5 devices. A license.json file next to the program (if there is one) tells
BidRidge where to check licenses; leave it there.


WINDOWS (10 and 11)
-------------------
1. Copy the "Windows" folder somewhere permanent (for example Documents).
2. Double-click BidRidge.exe.
3. If you see "Windows protected your PC": click "More info", then "Run anyway".
   You only do this once.
4. To pin it: right-click its taskbar icon -> "Pin to taskbar".
Jobs are saved in: %LOCALAPPDATA%\BidRidge


MAC (macOS 11 Big Sur or newer, Intel or Apple Silicon)
------------------------------------------------------
1. Drag BidRidge.app from the "Mac" folder into your Applications folder.
2. Double-click it. macOS will say it can't verify the developer.
   Click "Done" (or "OK"), then open System Settings -> Privacy & Security,
   scroll down, and click "Open Anyway" next to BidRidge. Confirm once more.
3. If macOS instead says the app "is damaged and can't be opened":
   open Terminal and paste this line, then press Return and open it again:
       xattr -dr com.apple.quarantine /Applications/BidRidge.app
Jobs are saved in: ~/Library/Application Support/BidRidge


LINUX (64-bit; Intel/AMD or ARM)
--------------------------------
1. Copy the "Linux" folder somewhere permanent.
2. In a terminal in that folder run:  sh install.sh
   BidRidge appears in your app menu. (Or just run ./bidridge)
Jobs are saved in: ~/.local/share/BidRidge


GOOD TO KNOW
------------
- Each computer keeps its own jobs. To move them, use "Save backup file" on
  one and "Import backup file" on the other. Save a backup every week.
- BidRidge runs on your computer (address 127.0.0.1:47915). Your jobs and
  customers stay on this computer unless you turn on sync or send a document
  to a customer, and both of those are encrypted on your computer first. The
  app also checks its license now and then (a coded computer ID and your
  license key), and sends anonymous job results only if you turn on "Share job
  data" in Settings.
- Help in the app opens the full user guide (also at bid-ridge.com/guide/).
- After you close the window, the program exits on its own within a couple
  of minutes.
- To update: replace the program with the new one. Your jobs stay.
